home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / windows / pmcstex.zip / PMCSTEX.INF (.txt) < prev    next >
OS/2 Help File  |  1996-06-08  |  31KB  |  685 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. 1 Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.  pmCSTeX for EPM is a macro package for the editor EPM (free editor for OS/2). 
  5.  It adds some buttons on the toolbar and CSTeX submenu into EPM's menu, 
  6.  allowing user to access many (em)TeX-related actions. 
  7.  
  8.  The aim of this work was the implementation of a pleasant menu system for 
  9.  OS/2. Editor EPM has been chosen since it provides wonderful programming 
  10.  capabilities, and, what it is the most important for the Czech users, there is 
  11.  a programmable Czech keyboard implemented by Z. Wagner (you can get it 
  12.  anonymously from ftp.icpf.cas.cz). (It should be noted that the keyboard that 
  13.  IBM includes in Warp is nearly unusable for programmers since they prefer a 
  14.  reasonable combination of US and Czech keyboard layouts, not standard Czech 
  15.  typing machine layout.  It is really bad that IBM does not provide 
  16.  configurable keyboard driver or its source code.) 
  17.  
  18.  This package is called pmCSTeX since it is related to the CSTeX distribution 
  19.  and because it was worked out by me (pm).  CSTeX (Czech and Slovak TeX) is 
  20.  being released since 1993 and it is based on the TeX implementation by E. 
  21.  Mattes (the famous emTeX).  In addition to the standard emTeX distribution, 
  22.  there are programs and styles that support typesetting in  Czech and Slovak 
  23.  languages. CSTeX includes an installation program (which is missing in emTeX) 
  24.  and a very pleasant menu system for DOS. However, the pmCSTeX package does not 
  25.  require CSTeX installation; you can use it with any (em)TeX distribution. 
  26.  
  27.  Working on pmCSTeX for EPM, the author was motivated by the following 
  28.  packages: 
  29.  
  30.  o CSTeX MNU for DOS: TeX menu system for DOS, included in CSTeX distribution. 
  31.    Author: Petr Ol╤ç╨░k 
  32.  
  33.  o TeXshell: Turbo Vision TeX developing system (for DOS and DOS window in 
  34.    OS/2). I liked it very much (I like Borland-like environments, on-line help 
  35.    etc.), it is programmable in a wonderful way. However, it's just DOS, it has 
  36.    64KB limit on file sizes, it crashed from time to time (in my OS/2 window), 
  37.    and there is no "Undo" function. Author: Juergen Schlegelmilch 
  38.  
  39.  o EPMTeX: TeX menu system for editor EPM. Good, but it does not fulfilled my 
  40.    high expectations I got accustomed to in TeXshell (e.g. it always appends 
  41.    the Master file at the command line). I accepted its First line syntax 
  42.    (Master:, Format: etc.). Authors: Jon Hacker and Rodney Korte 
  43.  
  44.  o WETeX: actions and icons are defined to tex, preview (and more) of a 
  45.    document. Based on EAs, not Master: notation. I do not use it since I do not 
  46.    use WPS (my computer has not got enough RAM). Author: ZdenΓò¬k Wagner 
  47.  
  48.  o emacs: well, I never used this editor except very simple editing (I prefer 
  49.    vi on unix). However, I was always amazed by its feature "(La)TeX current 
  50.    paragraph"---therefore I implemented it in pmCSTeX for EPM as well. Authors: 
  51.    GNU 
  52.  
  53.  o pmgraf: that's my integrated Turbo Vision environment for 2d and 3d graph 
  54.    plotting (see my WWW page for more details). The build-in editor contains 
  55.    hotkeys for pull-down menus for LaTeX environments and font sizes, and a 
  56.    Greek keyboard. Thus I implemented these features into EPM as well. Author: 
  57.    Petr Mikul╨▒k 
  58.  
  59.  This package is FREEWARE. This package is provided AS IS and the author is NOT 
  60.  RESPONSIBLE FOR ANY PROBLEMS that can arise from the use or misuse of pmCSTeX 
  61.  for EPM.  I'm not EPM programmer, I'm physicist.  Don't blame me if something 
  62.  wrong happend to your .tex files, but send me the bug report. Or even better: 
  63.  send me the solution with the appropriate patch. 
  64.  
  65.  This package was developed and tested on EPM 6.03 and EPM 6.03b. Get the 
  66.  latest version of EPM if you have an older one. 
  67.  
  68.  AUTHOR: 
  69.  
  70.  Petr Mikul╨▒k 
  71.  
  72.  Department of Solid State Physics, Faculty of Science, Masaryk University, 
  73.  Kotlarska 2, 611 37 Brno 
  74.  
  75.  Katedra fyziky pevn╨Æ f╨░ze, p┬ñ╨▒rodovΓò¬deck╨░ fakulta, Masarykova univerzita, 
  76.  Kotl╨░┬ñsk╨░ 2, 611 37 Brno 
  77.  
  78.  e-mail: mikulik@physics.muni.cz 
  79.  
  80.  URL: http://www.sci.muni.cz/~mikulik/ 
  81.  
  82.  pmCSTeX is available on hobbes.nmsu.edu (directory os2/unix/tex), on 
  83.  ftp.leo.org (directory pub/comp/os/os2/emTeX/contrib) and on CTAN mirrors 
  84.  (directory CTAN/systems/os2/pmcstex). Online documentation and the up-to-date 
  85.  bug fix list (if needed) is available on my WWW page. Further, pmCSTeX is 
  86.  included in my os2.zip modul for CSTeX'96 distribution (see my WWW page). 
  87.  
  88.  This is version: 8.6.1996 
  89.  
  90.  Note: The coincidence of the abbreviation of my name and the abbreviation of 
  91.  the Presentation Manager is just accidental.  Unfortunately, IBM does not pay 
  92.  me any royalties.  Thus even this package is free, you are welcome to send me 
  93.  donations :-)  (joking... postcards are welcome, but sending a short e-mail is 
  94.  more easier and rapid) 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 2. 2 Installation ΓòÉΓòÉΓòÉ
  98.  
  99.  I hope you already unzip-ed pmCSTeX.zip in an empty directory. Let us suppose 
  100.  you correctly installed EPM (I use 6.03) to the directory E:\APPS\EPM. Thus 
  101.  make directory E:\APPS\EPM\CSTeX and move all files you unpacked from 
  102.  pmCSTeX.zip into it. If you are not user of CSTeX'96 installation, then rename 
  103.  CSTeX_.ex to CSTeX.ex (that _ means that CSTeX.e has been compiled with 
  104.  CSTEX_CSTEX = 0, see below). 
  105.  
  106.  Edit config.sys and change it like 
  107.  
  108.  Example: 
  109.  
  110.   EPMPATH=...;E:\APPS\EPM\CSTeX;...
  111.  
  112.  and be sure that the environmental variable EMTEXOPT is set up like that 
  113.  
  114.  Example: 
  115.  
  116.   SET EMTEXOPT=/mt65000 /mp65000
  117.  
  118.  (this change with the change of .cmd files has been made on 19.5.1996, see 
  119.  History). 
  120.  
  121.  Then edit E:\APPS\EPM\actions.lst and add these two lines to the top of that 
  122.  file: 
  123.  
  124.  Example: 
  125.  
  126.   CSTeX
  127.   pm4EPM
  128.  
  129.  Now edit E:\APPS\EPM\Profile.erx and add these two lines to the bottom: 
  130.  
  131.  Example: 
  132.  
  133.   'link pm4epm'
  134.   'link CSTeX'
  135.  
  136.  If these two files are not present in your EPM directory, unpack them from 
  137.  pm_erx.zip and consult another documentation what are these files about. 
  138.  
  139.  I'm sure you want the on-line hypertext help about LaTeX2e commands. Thus take 
  140.  l2e_ndx.zip and unpack it in the directory %EMTEXDIR%\BOOK\ENGLISH (like 
  141.  E:\EMTEX\BOOK\ENGLISH). Read ltx_inf.rme how R. Niepraschk created 
  142.  LaTeX2e.INF. Then read !CTINDX (in Czech) or !READNDX (in English) how I have 
  143.  created LaTeX2e.NDX.  Follow the instructions there---you have to modify your 
  144.  config.sys to have 
  145.  
  146.  Example: 
  147.  
  148.   SET BOOKSHELF=..;E:\EMTEX\BOOK\ENGLISH;...
  149.   SET EPMPATH=...;E:\EMTEX\BOOK\ENGLISH;...
  150.   SET HELPNDX=...+LaTeX2e.NDX
  151.  
  152.  Now reboot your computer. When it is done, go to E:\APPS\EPM\CSTeX and type 
  153.  
  154.  Example: 
  155.  
  156.   start epm example.tex inc.tex
  157.  
  158.  A new menu item CSTeX should appear on the menu bar. If not, something was 
  159.  wrong and you should repair it (have a good chance!). Probably you have not 
  160.  checked options in File/Settings/Misc. 
  161.  
  162.  Now check the CSTeX toolbar. Go to File/Settings/Toolbars, use "Import" file 
  163.  E:\APPS\EPM\CSTeX\CSTeX.bar, name it CSTeX toolbar and then "Make current". 
  164.  Admire it. If you are not satisfied, change the toolbar as you wish (but do it 
  165.  next day). 
  166.  
  167.  Please verify that you can run from the command line commands latex 
  168.  (=latex2e), plaintex, latex209 etc. (CSTeX'96 users shoudl have cslatex, 
  169.  csplain, cslatex209 etc.). You should have installed emTeX in such a way, that 
  170.  you have latex.cmd, plain.cmd,... (or latex.cmd = cslatex.cmd, csplain.cmd, 
  171.  cslatex209.cmd,...) in %EMTEXDIR%\bin. So you should be able to recompile the 
  172.  LaTeX document typing in an OS/2 window 
  173.  
  174.  Example: 
  175.  
  176.   latex _any_latex_document_.tex
  177.  
  178.  And you should be able to start the previewer by 
  179.  
  180.  Example: 
  181.  
  182.   start dvipm @dvipm.cnf _any_latex_document_.dvi
  183.  
  184.  (I supposed you copied lj.cnf or p6l.cnf or whatever resolution you want to 
  185.  dvipm.cnf). If the above does not work, configure emTeX properly. You can copy 
  186.  the files from pm_bins.zip to %EMTEXDIR%\bin. In any case, copy cykl*.cmd 
  187.  files from it to that directory. 
  188.  
  189.  Check the last lines of %EMTEXDIR%\bin\maketexp.cmd file if you want that 
  190.  dvips gene